home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 612a.lha / VectorLibDocEng>CAM594 / vectorlib.doc.ENG next >
Internet Message Format  |  1992-02-12  |  5KB
  1. Path: IRO.UMontreal.CA!bonnie.concordia.ca!uunet!cis.ohio-state.edu!rutgers!ub!acsu.buffalo.edu!ubvmsb.cc.buffalo.edu!opnsmurf
  2. From: opnsmurf@ubvmsb.cc.buffalo.edu (Da Smurf)
  3. Newsgroups: comp.sys.amiga.programmer
  4. Subject: Vector.Library READ.ME translation.
  5. Message-ID: <1992Feb11.054545.20705@acsu.buffalo.edu>
  6. Date: 11 Feb 92 05:47:00 GMT
  7. Sender: usenet@acsu.buffalo.edu
  8. Organization: ... or lack thereof.
  9. Lines: 121
  10. News-Software: VAX/VMS VNEWS 1.41
  11. Nntp-Posting-Host: ubvmsb.cc.buffalo.edu
  12.  
  13.  
  14.     Here's the translation for the document which accompanies
  15. "vec_lib.lzh", a 3d object manipulation library. I haven't really 
  16. looked at the archive yet... and the documentation is kindof sparse.
  17. Well... here it is:
  18.  
  19. (I fixed up the translation a little, as it was more or less a literal
  20. translation and the translator had little knowledge of computers - making
  21. some parts confusing.)
  22.  
  23. -----------------------------------------------------------------------------
  24.  
  25.     Upon unpacking and later usage of the "vector.library" a few
  26. things should be paid attention to.
  27.  
  28.     - The library should be copied into the libs: directory of your
  29.     boot disk. Boot your Amiga from this disk in order to use the 
  30.     library. If you boot your Amiga from the Amiga Plus Disk (got me -Jm.)
  31.     the notice will appear: AmigaPlus is write protected. Click on
  32.     Cancel and boot from the previously mentioned disk. It does not have
  33.     to be the disk onto which you place the examples.
  34.  
  35.     - Because of legal reasons we can't supply the BASIC interpreter.
  36.     If you want to use the BASIC programs, you have to copy the inter-
  37.     preter from you Extras disk into the directory which has the BASIC
  38.     demos. (not true, but I digress -Jm.)
  39.     
  40.     - The graphics data for the BOBs are located in the directory VBOBSs.
  41.     So that the demo programs can find them, you must give the following
  42.     command in the CLI window before starting the demos:
  43.         ASSIGN VBOBS: <directory-you-unpacked-in>/VBOBS
  44.     This command must be given before every usage of the programs,
  45.     unless you change the path in the source text of the programs.
  46.  
  47. SUPPLEMENT TO THE TEXT:
  48. =======================
  49.  
  50.     The function SetColors has the following syntax:
  51.         Error = SetColors(ViewStruct,ColorTable)
  52.           D0  =  -108        A0        A1
  53.  
  54.     In the update version (V1.66) the dual-playfield mode is not 
  55.     supported.
  56.  
  57.     The "vd_cube" demos are designed for the beginners in the
  58.     momentary language for educational purposes. (Probably means
  59.     in the language that you are currently using - Jm.)
  60.  
  61. REFERENCE FOR C PROGRAMMERS:
  62. ============================
  63.  
  64.     Pragma commands lie in "vector.h" as well as the assemler routine
  65.     "vector_stub.a". If your C compiler doesn't accept "pragma" you
  66.     should remove these commands from the include file and add a newly
  67.     assembled version from "vector_stub.a" at the link mode.
  68.  
  69.     Example programs with added Assembler pieces must be compiled with
  70.     large data format and with assemble optimizing turned off.
  71.  
  72. REFERENCE FOR BASIC PROGRAMMERS:
  73. ================================
  74.  
  75.     Examples with more complex objects require a few seconds before they
  76.     will be seen after the RUN command.
  77.  
  78.     (The translator had difficulty with the final paragraph. I included
  79.     it here. He tried to translate parts of it.)
  80.  
  81.     (It says something about basic programmers being able to copy from
  82.     the multiplication table or some such. Also, apparently, that it
  83.     is easy to translate from basic to assembler/C using the
  84.     SAVE "name",A   command which will allow you to load the BASIC
  85.     code into any text processor for manipulation and translation. 
  86.     hmmm....)
  87.  
  88.     (For anyone who wishes to make a translation:)
  89.  
  90.     ubrigens konnten BASIC-Programmierer von der Multiplikation
  91.     der Eckpunkte einer Flache mit vier (bei den Eintragen in
  92.     den Flachentabellen) absehen, wovon allerdings zugunsten
  93.     der leichteren uberstragbarkeit in andere Programmier-
  94.     sprachen abzuraten ist. Die Konvertierung von und zu C
  95.     beziehungsweise Assembler wird durch den BASIC-Befehl
  96.     "save 'name',a" unsterstutst, da er ein BASIC-Programm als
  97.     ASCII-Datei - fur jeden Texteditor lesbar - ablegt.
  98.  
  99. -----------------------------------------------------------------------------
  100.  
  101. End of translation...
  102.  
  103.     Well, it doesnt talk too much about the routine calls in the library.
  104. In fact, it seems to say almost nothing about them. Questions from me:
  105. Does anyone know the format of the routine calls? Does anyone know the data
  106. structure format?
  107.  
  108. LLAP
  109. .
  110. .
  111. .
  112. Jm.
  113.  
  114. -------Here are the routines (from the .fd file)...
  115.  
  116. ##base _VecBase
  117. ##bias 30
  118. ##public
  119. SetVBI(VBIProg)(a1)
  120. InitVBOBs(Depth,BOBName,BOBList,Size-Table)(d0,a0,a1,a2)
  121. OpenVScreen(NewVScreen)(a1)
  122. CloseVScreen()()
  123. UseJoy(Object,Joy)(d0,a1)
  124. DoAnim(World)(a1)
  125. RotateX(X,Y,Z,CX,CY,CZ,Angle)(d0,d1,d2,d3,d4,d5,d6)
  126. RotateY(X,Y,Z,CX,CY,CZ,Angle)(d0,d1,d2,d3,d4,d5,d6)
  127. RotateZ(X,Y,Z,CX,CY,CZ,Angle)(d0,d1,d2,d3,d4,d5,d6)
  128. FreeVBOBs()()
  129. AutoScaleOn(ViewModes)(d0)
  130. AutoScaleOff()()
  131. FreeJoy()()
  132. SetColors(ViewStruct,Color-Table)(a0,a1)
  133. ##end
  134.  
  135.